吉星立绘 Mod 制作器 —— 使用说明 & 测试要点
==========================================

【启动】
双击根目录的【启动 吉星立绘Mod制作器.bat】即可（已内置运行环境，电脑不用装任何东西）。
程序文件都在 data 文件夹里，不用管它，找启动文件只看根目录就行。
首次启动若 Windows 提示"已保护你的电脑/未知发布者"，点【更多信息】→【仍要运行】。
（启动时会一闪而过一个黑色小窗，是正常的，随后主界面就会打开。）

【基本流程】
1. 点【游戏目录】，选择你的游戏路径：
   ...\Astral Party\...\AstralParty_CN_Data\StreamingAssets\aa\StandaloneWindows64
   （首次会扫描约 10 秒建立索引，之后秒开）
2. 左侧选角色，右侧显示该角色全部立绘（按皮肤分组：原皮 / 皮肤01 / 皮肤02 / Max）。
3. 替换立绘：把图片【拖到对应格子上】，或【双击格子】选图。
   · 当图片比例和目标不一致时，会弹出【调整布局】窗口（见下）。
4. 改过的格子变绿，原文件会自动备份。

【PC / B服资源目录（两种方式都直接支持）】
双击同一个【启动 吉星立绘Mod制作器.bat】后，在【游戏目录】直接选资源根目录即可；不需要桥接、硬链接或复制文件。

· 普通 PC 版：选择含 .bundle 文件的 StandaloneWindows64 目录。
· B服套壳目录：选择 AssetBundles 根目录，工具会自动识别“外层哈希目录 → 内层哈希目录 → __data / __info”：
  E:\CDriveRelocated\Administrator\AppData\LocalLow\feimo\AstralParty_CN\com.unity.addressables\AssetBundles
· 图包导入、替换、导出、还原都直接针对所选的真实文件。B服每个 __data 的备份会按原相对目录保存，避免同名 __data 互相覆盖。
· 操作前先完全关闭吉星派对；替换后重进游戏或对应界面查看效果。

【调整布局窗口（重点新功能）】
拖图替换时若比例不符会自动弹出。把你的图自由摆放到目标画布上：
   · 拖动 = 移动图片；滚轮 / +− = 缩放；方向键 = 微调（Shift 大步）
   · 【适应整图】= 整张图完整显示（周围留透明）
   · 【填满画布】= 放大铺满（超出部分裁掉）
   · 【居中】= 摆回中间
   · 亮区(画布)内就是最终效果，外面会被裁掉
   这样横版/方形图也能完整放进竖版卡面，人物想多大、放哪都行。

【右键格子菜单】
   · ✂ 裁切替换…   —— 重新选图并打开调整布局窗口
   · 📤 导出这张图… —— 把当前立绘导出成 PNG
   · 📁 定位 bundle  —— 在资源管理器中找到对应文件

【拖出导出】
   直接把缩略图从格子【往桌面/文件夹拖】，即可导出该图 PNG（和拖入对称）。

【图包】
   · 导出图包：把改过的立绘打包成 .jxpack 分享。
   · 导入图包：选一个 .jxpack 一键套用（按贴图名匹配，换版本也不失效）。
   · 分目录资源：当前目录能匹配的图会全部替换，匹配不到的只计入“未匹配”，不会中断整包。
     如果 B服把资源分在两个目录，可切换到下一个目录，再导入同一个图包继续覆盖。
   · 旧格式图包只要包含贴图名，也会自动改用按贴图名匹配，尽量覆盖当前目录的所有对应位置。
   · 迁移旧mod：把旧版失效的 mod 一键转成新图包。

【还原】
   点【还原】可把所有改动恢复成游戏原始文件。

【缩放 / 重命名】
   Ctrl + 滚轮 缩放缩略图大小；右键左侧角色名可重命名（卡图不支持）。

==========================================
【测试要点 —— 麻烦帮我重点试这几条】
==========================================
1. ★界面★ 你的电脑分辨率/系统缩放下，顶栏按钮、文字、各窗口排版是否正常、有无挤压截断。
   （上个版本在有的电脑上会挤框，这版专门修了，重点看这个）
2. 打开游戏目录，能否正常加载左侧角色列表（首次约 10 秒）。
3. 左侧切换不同角色，右侧立绘加载是否流畅、分组是否正确。
4. ★最关键★ 拖图替换一张立绘 → 进游戏看能否正常显示、有无变形或报错。
5. ★新功能★ 替换卡面/卡面2（竖版），试试【调整布局】窗口：缩放、拖动、适应/填满，
   摆好后确定，看进游戏效果对不对。
6. 拖出导出：把缩略图拖到桌面，看是否导出 PNG。
7. 右键格子：裁切替换 / 导出 / 定位 bundle 是否正常。
8. 导出图包 → 还原 → 再导入，能否完整复原。

【注意】
· 所有替换前都会自动备份到 游戏目录\_原始备份，可随时【还原】，放心试。
· 替换后需要重进游戏或重进对应界面才能看到效果。
· 游戏更新后，重新打开工具会自动重建索引。

有任何问题、闪退、显示异常，随时把情况（最好带截图）发我！
